home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-04 / instlr12.zip / INSTLR12.DOC < prev    next >
Text File  |  1992-06-29  |  8KB  |  173 lines
  1.  
  2.  
  3.  
  4.                                        - 1 -
  5.  
  6. INSTALLER 1.2 -- Updated 92-06-28
  7. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  8.  
  9. by Rick Pedley, Coffee Mug Software
  10.                 95 Notch Hill Road, Suite 306
  11.                 Kingston, Ont. K7M 5Y6
  12.                 Canada
  13.  
  14. *** NEW ***
  15.  
  16. 1. Installer now correctly runs a .BAT or .COM file after installation is
  17.    complete, as well as .EXEs.  Previously, only .EXEs ran correctly.
  18.  
  19. 2. Installed files now are stamped with the date and time of the original
  20.    files, and if the 'Copy only new files' option is selected, the file
  21.    comparisons are made based on name, date, time, and file length; if any
  22.    item doesn't match, the file is considered new.
  23.  
  24. 3. Exploding windows can be turned off; if on, the explosion speed has
  25.    been doubled.
  26.  
  27. 4. Mono adapters are now detected and appropriate colors selected.  Mono
  28.    operation can also be forced with a /b or /m switch (actually only the
  29.    'b' and 'm' are checked for -- the switch symbol is unneccesary). An
  30.    'h' or '?' as a switch explains the mono switch.
  31.  
  32. 5. This is the last freeware version.  I'm now beginning work on a beefed
  33.    up installer that hopefully will still be as easy to use.  The cost
  34.    will be somewhere between $20 - $30 US and will be distributed as
  35.    shareware.
  36.  
  37. INTRODUCTION
  38. ~~~~~~~~~~~~
  39.     This is a freeware product but if you send me $5 I won't throw it
  40. away.  Use it as you wish, no credit need be given, but neither do I accept
  41. any responsibility if it doesn't perform as expected.
  42.  
  43.     Installer is designed for programmers who want the user to be able
  44. to easily install their product on a hard disk, without having to explain
  45. how to create subdirectories and copy files (which they won't read or under-
  46. stand in any case).  If the user can log onto a floppy by typing its letter
  47. and a colon, and then type INSTALL, this utility will take care of the rest.
  48. If the user can't manage even this modest feat, he or she should buy a
  49. MacIntosh.
  50.  
  51. INSTRUCTIONS
  52. ~~~~~~~~~~~~
  53. 1. Start by copying all these files preferably to a floppy, or to a new hard
  54.    drive subdir'y.
  55.  
  56. 2. Next, run INSTALL and get a feel for how it works. I've configured it to
  57.    copy any files it finds on the source disk into a default subdir'y. Specify
  58.    another subdir'y if you wish. The DUMMY program is there only so you can
  59.    see the whole process. (INSTALL doesn't SHELL for any operations.)
  60.  
  61. 3. When installation is completed, either have it run the small dummy .EXE
  62.    program, or exit to DOS.  The idea here is simply to see what it does.
  63.  
  64.  
  65.  
  66.                                     - 2 -
  67.  
  68. 4. Run CONFINST.  The first thing CONFINST does is make a copy of PROGINST.TPL
  69.    and call it INSTALL.EXE.  All configuration changes will be made to this
  70.    new file INSTALL.EXE.  PROGINST.TPL is left in its original form, and I
  71.    have set the +r attribute to give it a little protection.  If an uncom-
  72.    pressed INSTALL.EXE is already present, CONFINST reads the data out of
  73.    this file and uses it as the default values; otherwise an entire new copy
  74.    of INSTALL.EXE is made.
  75.  
  76. 5. You are now guided through up to 7 screens of prompts.  Most of them are
  77.    self-explanatory so I'll just comment briefly on a few of them:
  78.  
  79.    File name of install utility: usually this will be INSTALL.EXE and this is
  80.    the file that CONFINST works on. If you specify another name, CONFINST will
  81.    rename INSTALL.EXE before exiting.  Be sure to include the extension .EXE;
  82.    CONFINST doesn't error-check for this.
  83.  
  84.    File name of executable: any program you want to run when all files have
  85.    been installed, be sure to include the extension.  Can be an EXE, COM, or
  86.    BAT file.  If left blank, INSTALLER just exits at completion.
  87.  
  88.    Default target directory: six levels deep are supported.  Some error
  89.    checking is done here, but follow the example shown.  If installing in
  90.    the parent directory, just enter C: for example.  Also, the source files
  91.    must be all at the same level -- INSTALL won't copy subdir's and their
  92.    contents from the source disk (the next version will).
  93.  
  94.    Target drive space: how much space should there be on the target drive for
  95.    the files you're installing?  Allow more room if further new files are
  96.    created by your own program.  Note the number is in bytes, not Kbytes.
  97.  
  98.    Copy All?...: `only different files' means files that either have different
  99.    names, lengths, file dates & times.  `prompt for each' means the user will
  100.    be asked for permission to install each file on an individual basis.  15
  101.    disks, 1000 files per disk are allowed.
  102.  
  103.    Copy install utility too?: this option overrides Copy All -- in other words,
  104.    you can elect to copy all files EXCEPT the install utility.
  105.  
  106.    The next 20 options specify the colors for various titles, menus, boxes...
  107.    Accept the defaults if you're not sure what to do.  It helps to have a color
  108.    chart handy for this section.  Note that all 16 colors are available for
  109.    foreground and background.  (REAL programmers of course, long ago memorized
  110.    all the color codes.)  Monochrome adapters are now supported (see NEW
  111.    above).
  112.  
  113.    Look for this file on Disk #1: Pick one unique file name to act as a flag on
  114.    each distribution diskette (include the extension, as usual).  Include a
  115.    number on each diskette label so the user can quickly find the right disk to
  116.    insert next. INSTALL tries three times to find this flag file: the first two
  117.    times, it displays an error message; the third time it aborts installation &
  118.    returns to the main menu.  NOTE: if you distribute your product in more than
  119.    one disk format, make up a different INSTALL for each format.  As many as 15
  120.    disks are allowed, each with its own flag file.
  121.  
  122.    Title screen effect: the 'diagonal' effect is the one currently installed.
  123.    Try the other one to see what it looks like.
  124.  
  125.  
  126.  
  127.                                       - 3 -
  128.  
  129.    Installer title screen line #1-#4: anything you like here really. All four
  130.    lines will be displayed even if blank, so if you need only 2 for instance,
  131.    type all blanks into the top and bottom lines, so the remaining two are
  132.    centered vertically.
  133.  
  134.    1. Save current configuration and quit.
  135.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  136.     Writes the changes you made into INSTALL.EXE, renames the file to the
  137.    name you specified if it's different than INSTALL.EXE, and exits to DOS.
  138.    Because the data is written directly into the INSTALL.EXE file, no addit-
  139.    ional 'script' files are required.
  140.  
  141.    2. Quit without changing anything. -- just like it says.
  142.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  143.  
  144.    3. Re-start configuration from beginning. -- ditto, but you can also back up
  145.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  146.    a page at a time with Esc.
  147.  
  148.    4. Save configuration, compress with LZEXE & quit.
  149.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  150.         LZEXE is an excellent compression utility for EXE files by Fabrice
  151.    Bellard of France.  An EXE file compressed with this utility de-compresses
  152.    AFTER loading into memory and then runs.  This allows for significant space
  153.    saved on disks, and reduced loading time (de-compression is very fast). He
  154.    has given permission to use LZEXE free of charge and it can be found on just
  155.    about any BBS by this time.  If you have LZEXE, copy it into the same dir-
  156.    ectory as CONFINST.EXE and INSTALL.EXE.  NOTE: LZEXE is distributed as
  157.    `LZEXE91.ZIP' or `LZEXE91E.ZIP'. 
  158.         This option saves the configuration, compresses it with LZEXE (if
  159.    present), renames it to your specification if different than INSTALL.EXE,
  160.    then exits to DOS.  If you select this option and LZEXE isn't present, the
  161.    changes are written, and CONFINST exits leaving INSTALL uncompressed.
  162.  
  163.  
  164.    Lastly...
  165.    ~~~~~~~~~
  166.        Copy INSTALL.EXE (or whatever) to the first disk and be sure to give
  167.    instructions to the user on how to log on to the drive and run INSTALL.
  168.   
  169.  
  170.    Rick Pedley,  June 28, 1992
  171.  
  172.  
  173. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-